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Preface 


Intended Audience 

This manual is intended primarily for system programmers and application 
programmers. 

Document Structure 

This document consists of the following three sections: 

• Description—This section is in Part I. It provides a description of the National 
Character Set (NCS) Utility and detailed instructions on how to build NCS 
definition files. 

• Usage Summary—This section is in Part II. It outlines the following NCS 
information: 

- Invoking the utility 

- Exiting from the utility 

- Directing output 

- Restrictions or privileges required 

• Qualifiers—This section is in Part II. It describes the NCS qualifiers, 
including format, parameters, and examples. 

Associated Documents 

For related information about the NCS Utility, see the following documents: 

• OpenVMS DCL Dictionary 

• OpenVMS Programming Concepts Manual 

• OpenVMS User's Manual 

• OpenVMS Command Definition , Librarian , and Message Utilities Manual 

Conventions 

In this manual, every use of VMS means both the OpenVMS AXP and the 
OpenVMS VAX operating system. 

The following conventions are used in this manual: 

Ctrl/x A sequence such as CtrVx indicates that you must hold down 

the key labeled Ctrl while you press another key or a pointing 
device button. 

PF1 x A sequence such as PF1 x indicates that you must first press 

and release the key labeled PF1, then press and release 
another key or a pointing device button. 
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| Return | 


() 

[] 

{) 

boldface text 

italic text 

UPPERCASE TEXT 

numbers 


In examples, a key name enclosed in a box indicates that 
you press a key on the keyboard. (In text, a key name is not 
enclosed in a box.) 

A horizontal ellipsis in examples indicates one of the following 
possibilities: 

• Additional optional arguments in a statement have been 
omitted. 

• The preceding item or items can be repeated one or more 
times. 

• Additional parameters, values, or other information can be 
entered. 

A vertical ellipsis indicates the omission of items from a code 
example or command format; the items are omitted because 
they are not important to the topic being discussed. 


In format descriptions, parentheses indicate that, if you 
choose more than one option, you must enclose the choices 
in parentheses. 

In format descriptions, brackets indicate optional elements. 
You can choose one, none, or all of the options. (Brackets 
are not optional, however, in the syntax of a directory name 
in a VMS file specification, or in the syntax of a substring 
specification in an assignment statement.) 

In format descriptions, braces surround a required choice of 
options; you must choose one of the options listed. 

Boldface text represents the introduction of a new term or the 
name of an argument, an attribute, or a reason. 

Boldface text is also used to show user input in online versions 
of the manual. 

Italic text emphasizes important information, indicates 
variables, and indicates complete titles of manuals. Italic 
text also represents information that can vary in system 
messages (for example, Internal error number ), command lines 
(for example, /PRODUCER=raame), and command parameters 
in text. 

Uppercase text indicates a command, the name of a routine, 
the name of a file, or the abbreviation for a system privilege. 

A hyphen in code examples indicates that additional 
arguments to the request are provided on the line that follows. 

All numbers in text are assumed to be decimal, unless 
otherwise noted. Nondecimal radixes—binary, octal, or 
hexadecimal—are explicitly indicated. 





Parti 


Introduction to the National Character Set 

(NCS) Utility 


This part of the document introduces you to the National Character Set (NCS) 
Utility and provides details about building NCS definition files. 








NCS Description 

In processing strings, two common functions are collating and conversion. 
Collating sequences provide a means of comparing strings for sorting purposes; 
conversion functions provide a means for deriving an altered form of an input 
string based on a conversion algorithm. 

The National Character Set (NCS) Utility provides a common facility for defining 
collating sequences and conversion functions, registering them as definition 
modules in an NCS library, and providing a means for making them locally 
accessible to application programmers and system programmers. See Appendix A 
for a listing of the definition modules that are included in the default NCS 
library. 

Typically, NCS collating sequences are selective subsets of the Multinational 
Character Set. NCS collating sequences find widespread use in international 
applications. For example, a Spanish collating sequence would resolve sorting 
weights for characters you might encounter when processing strings from the 
Spanish language. 

NCS permits you to build collating sequences unique to your particular 
programming situation. For example, if you want the character C to collate 
between the characters G and H , you can retrieve the particular collating 
sequence from a central library, make the appropriate modifications, and then 
store the modified collating sequence in a local library that is readily accessible to 
your application program. 

You can implement NCS from an application program using the program 
interface that includes 10 callable NCS routines. The callable routines permit 
you to access collating sequences and conversion functions stored as definition 
modules in an NCS library. You can also use the NCS routines to save the 
definitions in a local library for subsequent use by comparison and conversion 
routines called from the application program. For instructions on using the NCS 
routines, see the OpenVMS Utility Routines Manual. 

This manual provides information about how to use NCS interactively, using the 
DIGITAL Command Language (DCL) interface for doing the following library 
operations: 

• Creating NCS libraries 

• Inserting definition modules in NCS libraries 

• Replacing definition modules in NCS libraries 

• Extracting definitions from NCS library modules 

• Deleting definition modules from NCS libraries 

• Other tasks associated with library operations, including listing the library 
contents, directing the output of the library, and logging library activities 

By default, DCL attempts to replace definition modules in the default NCS 
library with definitions from a specified source file. That is, if you specify no 
qualifiers, DCL assumes you want to replace definition modules in the default 
NCS library. If you specify no definition source file, DCL prompts you for one, as 
shown in the following example: 
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$ NCS 
_File: 

Any other library activity requires you to use one or more command qualifiers. 
You may designate any NCS library as the object of a command by assigning it 
the logical name NCS$LIBRARY. 

The rest of Part I provides instructions for building NCS definition files. 

1 How to Build an NCS Definition File 

The following subsections describe the language syntax you must use when 
building NCS collating sequence definitions and NCS conversion function 
definitions. You can use any standard text editor to build definition files. 

All definition files have the following characteristics: 

• Include one or more definitions. 

• Have no restriction on including a mix of collating sequence definitions and 
conversion function definitions in a single definition file. 

• Use the file type NCS. 

• Have comments delimited by an exclamation point (!). 

• Do not permit line continuation for comments. 

1.1 Naming NCS Definition Files 

Each definition file should begin with a name that describes its contents. For 
example, if you want to convert strings of multinational characters to lowercase, 
use a name like MULTI_TO_LOWER. You can name NCS definition files using up 
to 31 characters including the letters A through Z and a through z, the numbers 
0 through 9, the dollar sign ($), and the underscore character (_). Note that 
spaces are not allowed and that you may use either uppercase or lowercase letters 
when formulating definition names. 

1.2 Structuring a Definition File 

Each definition file consists of the following elements, in this order: 

1. Definition name 

2. Equal sign (=) 

3. Definition expression 

4. Terminating semicolon (;) 

A definition file has the following format: 

definition_name = definition_expression; 
definition_name = definition_expression; 


definition_name = definition_expression 

Example NCS-1 includes excerpts from a definition file that provides several 
EDT conversion functions. 
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Example NCS-1 Typical Definition File 

! Define the EDT fallback conversion function, and UNEDT, its inverse. 

! Note that applying EDT and then UNEDT to a file may not result in the 
! original file, if, for example, the original file contains the string " A A". 

i 

EDT_VT2xx = CF( 

CF = .IDENTITY, 

MODIFICATIONS=( 

%X00 = " A @\ 

%X01 = " A A", 

%X02 = " A B\ 


%XF0 = "<XF0>", 

%XFE = "<XFE>", 

IXFF = " <XFF>") ) ,* 

UNEDT_VT2xx = INVERSE(EDT_VT2xx); 

! 

!Start of definition EDT (a modified version of EDT_VT2xx) 

I 

EDT = CF( 

CF = EDT_VT2xx, 

MODIFICATIONS=( 

%XA0 = ”<XA0>", 

%XA1 = "<!!>", 

%XA2 = "<C/>", 


%XFB = "<u A >\ 

%XFC = "<u"">", 

%XFD = "<y”">")); 

! 

IDefinition UNEDT (the complement of EDT) 

i 

UNEDT = INVERSE(EDT); 

| 

(The next 2 definitions - EDT1 and UNEDT1 - are structured such that ... 

! UNEDT1(EDT1(string)) 

!... always gives the original string. 

I 

EDT1 = CF(CF=EDT,M0DI=( 

II A || _ II A _ || 

"<" = "<=")); 
i 

!The complement of EDT1 

i 

UNEDT1 = INVERSE(EDT1); 

Section 1.3 describes the notation used in NCS definitions. The expressions and 
keyword clauses that comprise NCS definitions are described in Sections 1.5 and 
1.6. 
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1.3 Notation Guidelines 

Table NCS-1 lists the language notation to be used in NCS definition files. 


Table NCS-1 NCS Language Notation 


Notation 

Meaning 

! 

Starts a comment 

0 

Establishes entity grouping for ordering operations. 

— 

In a collating sequence clause, reads literally left term collates 
as right term; in a conversion function clause, reads literally 
left term converts to right term 

> 

In a collating sequence clause, reads literally left term collates 
just greater than right term 

< 

In a collating sequence clause, reads literally left term collates 
just less than right term 

+ 

Within a clause, indicates string concatenation; in an 
expression, indicates an appended collating sequence 

* 

Indicates a series of expressions comprising one definition 

- 

Indicates a range of string data 

II II 

Encloses literal string data 

% 

Indicates the start of a string numeric value 

D 

Indicates a decimal numeric value 

H 

Indicates a hexadecimal numeric value 

0 

> 

> 

Indicates an octal numeric value 

Delimits expressions and clauses 

Terminates an NCS definition 


You can construct a definition in free form using indentation and one item per 
line to improve readability. For example, the following definition is functionally 
acceptable, but is difficult to read: 

FRENCH_NRC_TO_MULTI = 

CF (CF=_IDENTITY,MODIFICATIONS^ 


#" 

4-1 

’ll 

ii 

/ 

II 

h ) 

"a 

ii 

n 

[ 

ii _ ii O ii 

/ 

M_ 

ii r* ii 

V / 

"] 

ii _ ii 

§" 


II 

= "e", 


H _ 

"u", 

"} 

ii _ ii 

e" 

i 

/ 

1 /s 

a 

ii _ M ^ ii 

/ 

e" 

= "e" 

ii 

/ 

o 

< 

_ ii 

o' 

1 

/ 

ii 

> 

q 

if 

a-. 

a" 

= "a" 

ii 

/ 

~e" 

_ii 

e' 

1 

/ 

ii 

~o" =" 

6") 









i 

N 

-6571-GE 


Using indentation and one item per line makes the same definition much easier 
to read as shown in the next illustration: 
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FRENCH_NRC_TO_MULTI = CF ( 
CF = _IDENTITY, 
MODIFICATIONS^( 



= 

"£", 


= 

ii ^ li 

a. , 

II 1" II 

= 

ii O n 

/ 

II \ II 

= 

II n II 

V / 

II j II 

= 


II 1 II 

= 

" e", 

II 1 II 

= 

"u", 

II 1 II 

= 

"e" , 

II II 

= 

ii A ii 

a. , 

" A e" 

= 

"e" , 

" a O" 

= 

"6" , 

II /^-Q II 

= 

n u\ 

"~a" 

= 

ii ^ ii 

cl , 

"~e" 

= 

"e" , 

" ~o" 

— 

"6") 


ZK-6572-GE 

When you format a file for readability, do not omit the required punctuation. 

Strings can be represented literally and numerically. If you use literal strings (as 
in the preceding example), you must enclose them in double quotation marks (-). 

If you choose to represent strings numerically, you can use either decimal, 
hexadecimal, or octal numbers. You must precede numeric values by a percent 
sign (%) and the appropriate radix symbol (D for decimal, X for hexadecimal, O 
for octal). Note that you can use only digits that represent a single character, 
and that the radix notation must be less than decimal 256, regardless of the 
numbering system you use. 

For example, the following statement from the previous example may be coded 
using a literal string or a numeric string: 

"~e" = "e", ! literal string 

"~e" = "%XEB", ! "e" represented as hexadecimal number 

Numeric strings are particularly appropriate when processing characters from 
either the ASCII subset or the EBCDIC subset. 

1.4 Built-In Collating Sequences and Conversion Functions 

NCS includes two built-in definitions: the _NATIVE collating sequence and 
the _IDENTITY conversion function. You use the built-in definitions as a basis 
for creating other collating sequences and conversion functions. The built-in 
definitions are distinguished by the leading underscore in their names. Note that 
the built-in collating sequence and the built-in conversion function are not stored 
in the NCS library and cannot be modified. 

The _NATIVE collating sequence collates strings by ascending numeric value. For 
collating purposes, the null character (NUL) has the lowest value of all characters 
in the set. 
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Following is an example of how you might use the _NATIVE collating sequence to 
specify a collating sequence: 

MY_CS = _NATIVE * (MULTI_TO_NODIACRITICALS * MULTI_TO_LOWER) 

The .IDENTITY conversion function reproduces each input string character as an 
output string character, except for characters that are explicitly being modified. 
Following is an example of using the _IDENTITY conversion function: 

MY_CF = CF(CF = .IDENTITY, 

MODIFICATIONS^"ME" = "YOU" 

"NOW" = "THEN" 

"BLUE" = “RED") 

Using this conversion function, the input string Tell me now the sky is blue is 
converted to the output string Tell you then the sky is red. 

1.5 Definition Expressions 

You can define collating sequences and conversion functions using various types of 
expressions. Section 1.5.1 describes the types of expressions used in formulating 
collating sequences. Section 1.5.3 describes the types of expressions used to 
define conversion functions. 

Note that vertical ellipses are used in some examples to indicate omitted code. 

1.5.1 Collating Sequence Expressions 

You can define collating sequences using any combination of the following types of 
expression: 

• The name of an existing collating sequence 

• A sequential series of collating sequences 

• An expression that includes appended collating sequences 

• A modified collating sequence 

• A reversed collating sequence 

• A reordered collating sequence 

1.5.1.1 Definition Name You can create a new collating sequence by equating it 
to the name of an existing collating sequence, using the following format: 

new_collating_sequence = name_of_existing_collating_sequence, 

Following is an example of this type of expression: 

MY_COLLATING_SEQUENCE = MULTINATIONAL.!, 

1.5.1.2 Sequential Series of Expressions You can create a new collating 
sequence from a sequential series of expressions, including one or more conversion 
functions and an existing collating sequence, in the following format: 

new_collating_sequence = collating_sequence * conversion_function_1 * conversion_function_2, 

NCS processes the conversion functions first, going from right to left, and then 
applies the collating sequence. All processes are completed within a single pass. 

Following is an example of using a sequential series of expressions to create a 
collating sequence: 

MY_COLLATING_SEQUENCE = CS(CS = .NATIVE * MULTI.TO.NODIACRITICALS * MULTI.TO.UPPER), 

The conversion functions convert uppercase letters to lowercase letters and strip 
the diacritical marks. The result is then combined with the .NATIVE collating 
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sequence to derive a collating sequence that behaves as though the input strings 
have been converted and then compared by their numeric value. 

1.5.1.3 Expression with Appended Collating Sequences You can create a 
collating sequence using an existing collating sequence and up to two appended 
collating sequences, in the following format: 

new_collating_sequence = collating_sequence_1 + collating_sequence_2 + collating_sequence_3, 

NCS processes the leftmost collating sequence in the first pass, and proceeds to 
process each of the remaining collating sequences going from left to right, using 
an individual pass for each. 

You can include conversion functions with each of the collating sequences using 
the asterisk (*) operator, in the following format: 

new_collating_sequence = collating_sequence_1 * conversion_a * conversion^ + ... + ..., 

Although there is no limitation on the number of conversion functions you can 
use with each collating sequence, you should try to minimize the complexity of 
the expression by limiting the number of conversion functions. In a complex 
expression having several collating sequences with associated conversion 
functions, NCS applies conversion functions only to the related collating sequence. 
When NCS detects a distinction between the two strings being compared, the 
comparison function terminates. 

Following is an example of creating a collating sequence using an existing 
collating sequence with an appended collating sequence: 

MY_COLLATING_SEQUENCE = CS(CS = MULTINATIONAL^ + MULTINATI0NAL_2 * UPCASE * NODIACRITICALS), 

1.5.1.4 Modified Collating Sequence You can create a collating sequence from 
a modified collating sequence using keyword clauses, in the following format: 

new_collating_sequence = CS(keyword_clause,keyword_clause, ...), 

The expression begins with a definition identifier (CS) followed by several 
keyword clauses enclosed in parentheses and separated by commas. The first 
keyword clause identifies the collating sequence that serves as a basis for the 
new collating sequence, and the second keyword clause lists the appropriate 
modifications. 

Following is an example of an expression that uses keyword clauses to create 
a new collating sequence by modifying an existing collating sequence. Each 
uppercase character gets the same collating weight as the associated lowercase 
character. 


MY.COLLATING.SEQUENCE = 

CF(CF = .IDENTITY, 
MODIFICATIONS=( 

%X41-%X5A = %X61-%X7A, 
%XC0-%XCF = %XE0-%XEF, 
%XD1-%XDD = %XF1-%XFD)); 


! Base collating sequence 

! Modifications 
! to the base 
! collating sequence 


1.5.1.5 Reversed Collating Sequence You can create a new collating sequence 
by specifying the reverse order of an existing collating sequence, using the 
following format: 


new_collating_sequence = REVERSE(existing_collating_sequence) 

Using this form of expression, you might create a collating sequence where the 
letter C would collate greater than B, and the letter B would collate greater than 
A. 
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Here is an example of using a reverse order collating sequence expression: 

MY_COLLATING_SEQUENCE = REVERSE(.NATIVE), 

Using this expression, you could give collating weight precedence to lowercase 
characters over uppercase characters. 

1.5.1.6 Reordered Collating Sequence You can create a new collating sequence 
by reordering an existing expression through the use of parentheses. 

In the following example, NCS applies the conversion Junction and compares the 
input strings using collating_sequence_b as a comparison basis in the first pass. If 
the strings do not compare, NCS compares the strings using collating_sequence_a 
as a basis during a second pass. 

old_collating_sequence = collating_sequence_a + collating_sequence_b * conversion_function, 

If you want to do the comparisons in a single pass using the sum of the collating 
sequences, reorder the operation using parentheses, as shown in the following 
example: 

new_collating_sequence = (collating_sequence_a + collating_sequence_b) * conversionjunction, 

1.5.2 Collating Strings with Pad Characters 

In some instances, you may need to collate strings padded with one or more 
pad characters. Typically, a string may be padded with the ASCII SPACE 
character, but the pad character can be defined as any character. In order to 
avoid ambiguity when collating padded character strings, specify the collating 
value of the pad character in your collating sequence definition. For example, if 
you want to specify the collating weight of a pad character in a collating sequence, 
you might use the following statement: 

NATIVE_SPACEPAD = CS(CS=_NATIVE, MOD = ("" = %X20)); 

This states that the shorter string should be treated as if it were padded with 
spaces for collating purposes. For example, the string ABC<SPxSP> would have 
the same collating weight as the string ABC. 

1.5.3 Conversion Function Expressions 

You can define conversion functions using any combination of the following types 
of expression: 

• The name of an existing conversion function 

• A sequential series of conversions 

• A modified conversion function 

• An inverted conversion function 

• A reordered conversion function 

1.5.3.1 Definition Name You can create a new conversion function from an 
existing conversion function by equating the new function to the name of the 
existing function, using the following format: 

new_conversion_function = name_of_existing_conversion_function; 

Following is an example of this type of expression: 

MY.CONVERSION = MULTI.TO.LOWER; 
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1.5.3.2 Sequential Series of Conversions You can create a new conversion 
function by expressing it as the result of a sequential series of conversions, using 
the following format: 

new_conversion_function = conversion^ * conversion_2 * conversion_3; 

NCS applies a sequential series of conversions in a single pass beginning with 
the rightmost conversion and continuing right to left. In the preceding format, 
conversion_3 is applied before conversion_2, and conversion_2 before conversion_1. 

Following is an example of a conversion function derived through a sequential 
series of conversions: 

MY_CONVERSION = MCS.NODIACRITICALS * MCS_LOWER; 

1.5.3.3 Modified Conversion Function You can create a conversion function 
from another conversion function appropriately modified through the use of 
keyword clauses, in the following format: 

new_conversion_function = CF(keyword_clause,keyword_clause, ...) 

The expression begins with a definition identifier (CF) followed by several 
keyword clauses enclosed in parentheses and separated by commas. The first 
keyword clause identifies the conversion function that serves as the basis for 
the new conversion function. The second keyword clause lists the appropriate 
modifications. 

Following is an example of an expression that uses keyword clauses to create a 
new conversion function: 

EDT1 = CF(CF=EDT,MODIFICATIONS^ 

II A || _ II A _ || 

"<" = "<=")); 

In this example, the new conversion function (EDT1) is a modified representation 
of an existing conversion function (EDT). 

1.5.3.4 Inverted Conversion Function You can create a new conversion function 
by logically inverting an existing conversion function, using the following format: 

new_conversion_function = INVERSE(CF_expression) 

Typically, you use inversion when you want to restore a converted string to its 
original form. For example, assume you have the following conversion function: 

EDT1 = CF( 


: .IDENTITY, MODI = 

%X01 = 

II A || 

%X02 = 

" A B\ 

%X03 = 

II AQ || 

%X04 = 

" A D", 

%X05 = 

II Ag || 

%X06 = 

„ A F „, 

%X07 = 

" A G\ 

H ii _ 

%X00)); 


Now assume you want to convert the output string back to the original input 
string. To do this, you can use the following conversion function: 
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UNEDTl = INVERSE(EDT1) 

1.5.3.5 Reordered Conversion Function You can effectively reorder conversion 
functions using parentheses. For example, the following format results in a two- 
pass comparison where collating_sequence_a is used as the basis for comparing 
the input strings during the first pass: 

my_cs = collating_sequence_a + collating_sequence_b * conversions * conversion_d, 

If the strings do not compare, conversionjd and conversion^ are applied to the 
input strings and then the strings are compared on the second pass based on 
collating sequence _b. 

If you want a one-pass comparison that converts input strings and then compares 
them using the composite effects of collatingsequence_a and collating sequence _ 
b, add parentheses, as follows: 

my_cs = (collating_sequence_a + collating_sequence_b) * conversions * conversions!, 

1.6 Keyword Clauses 

Keyword clauses are the basic elements of a collating sequence definition. They 
are used to establish the basis for each collating sequence, to explicitly define 
modifications where applicable, and to optionally assign a version number to the 
collating sequence. 

As described previously, a definition expression can take the form of a definition 
identifier (CS or CF) followed by a set of one or more keyword clauses enclosed in 
parentheses and separated by commas, as follows: 

new_expression = CS(keyword_clause,keyword_clause, ...) 

All keyword clauses begin with a keyword followed by the equal sign and a value: 
keyword = value 

The value varies with the keyword, as shown in the next two sections. 

Note that you can abbreviate any keyword as long as the abbreviated form is not 
ambiguous. 

1.6.1 Collating Sequence Keyword Clauses 

There are four types of keyword clauses you can use to build a collating sequence 
expression: 

• CS 

• SEQUENCE 

• IDENT 

• MODIFICATIONS 

Each of these is described in the following subsections. 

1.6.1.1 CS Keyword Clause The CS keyword clause equates the keyword CS 
to a collating sequence expression that can take any one of the forms described 
in Section 1.5. The CS keyword clause typically establishes the collating basis 
for a collating sequence unless you use the SEQUENCE keyword clause. The CS 
keyword clause uses the following format: 

CS = CS_expression 

The following example illustrates the use of the CS keyword clause: 
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MULTINATIONAL^ = CS( ! Define temporary for second pass. 

IDENT = "VI.0", 

CS = _NATIVE * MULTI_TO_UPPER, 

MODIFICATIONS:;( 

%XC6 > "Z", ! AE diphthong 

%XD8 > %XC6, ! 0 with slash 


%XE0-%XEF = %XC0-%XCF, 

%XFl-%XFD = %XDl-%XDD ) ); 

1-6.1-2 SEQUENCE Keyword Clause The SEQUENCE keyword clause 
establishes the collating basis for a collating sequence when the CS keyword 
clause is not appropriate. Typically, you use this keyword clause when you do not 
have an existing collating sequence that is appropriate for your application and 
thus must fabricate one. 

The following example illustrates the use of the SEQUENCE keyword clause in 
fabricating the Dutch collating sequence: 


DUTCH = CS( 

SEQUENCE = (%X00-"N", "N", "O "-" Z" , “iE", "0", "A", "{"_" ^ ; %XD0, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", ”A"-"A" = "A", "0" = “C", "E"-"E" = "E", 


II p II 

_ ii j ii _ 

II p II 

, "O' 

II _ II Q II _ 

"O", "U"-"t 

j" = "U", 

H Y" - 

"Y", "a"- ,, a" = "A" 

"a" 

-"ae" = 

"A" 


II ^ II _ 

f V — 

"C", "e"-"€ 

5„ = "E", 

H p H _ a P 

n 

M 

ii 

^ii 

"6" 

-"6" = 

"O” 

, " 0 1 

" = "0", 

"u"-"u" = 

"U", "y" 

= "Y" , 

"OS" = "OE ", 


= "SS" 

II 

OB" = 

: " OS" , " 

" < %X00)) 




SEQUENCE = 

(%X00- 1 

"A ", "A" 

-"A" , "B"- 1 

■C", "Q"/ 

" D" —" E 

M " g _" g ii 

up ii 

_ ii p ii ii j 


n i" f 

" J"-"N" 

, "N", "CE" 

, "0", "0 

"-"6", 

"P"-"R", "S", 

"S" 

-"U\ "I 

J"- 

"U", 

ii y" — " y 

ii y ii ii ^ ii 

"A", "0 r 

"A", 

ii r ii ii / ii ii r ii ii . ii 

L / 1 ~ C r 


%XD0, %XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS= ( "a"-“ z" = "A"-"Z", " A " - " i " = "fl" - "y" = "N"-"7" ) ) 

+ REVERSE(_NATIVE); 


ZK-6573-GE 


In this example, the first SEQUENCE keyword clause establishes the collating 
sequence for the entire character set from %X00 through %XFF during the first 
pass. The associated MODIFICATIONS keyword clause effectively masks the 
lowercase characters and diacritical characters by equating each lowercase 
alphabetical character to its related uppercase alphabetical character, and 
by equating each diacritical character to its related nondiacritical, uppercase 
character. 

During the second pass, the second SEQUENCE keyword clause establishes 
the collating sequence for the diacritical characters. The associated 
MODIFICATIONS keyword clause masks all lowercase characters, both 
diacritical and nondiacritical, by equating them to their related uppercase 
character. 
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1.6.1.3 IDENT Keyword Clause The IDENT keyword clause is a special- 
purpose keyword clause that permits you to assign a version number to the 
collating sequence. The following example illustrates using the IDENT keyword 
to assign Version 1.0 to the Spanish collating sequence: 

SPANISH = CS( 

IDENT = "VI.0", 

CS = MULTINATIONAL, 


) ); 

1.6.1.4 MODIFICATIONS Keyword Clause The MODIFICATIONS keyword 
clause is typically used with the built-in collating sequence _NATIVE to derive a 
modified version of the collating sequence. 

In the following example, the new collating sequence (MULTINATIONAL_l) 
applies two conversion functions (MULTI_TO_NODIACRITICALS and MULTI_ 
TO_UPPER) to the input strings. Then the collating sequence uses a modified 
version of the built-in collating sequence, _NATIVE, as the basis for comparing 
the strings. 

The first group of modifications assigns collating weights to the listed special 
characters. For example, the uppercase N tilde character N is assigned the 
same collating weight as the alphabetic character (N). The second group of 
modifications gives each lowercase character the same collating weight as the 
associated uppercase character. 

MULTINATIONALS = CS( 

CS = _NATIVE * ( MULTI_TO_NODIACRITICALS * MULTI_TO_UPPER ), 

M0DIFICATI0NS=( 


Special characters 


1 

%XC6 > 

"Z\ 

! AE diphthong 

%XD8 > 

%XC6, 

! 0 with slash 

%XC5 > 

%XD8, 

! A with ring 

%XD1 > 

"N", 

! N tilde 

%XDF = 

”SS\ 

! S sharp 

%XD7 = 

i 

*0E\ 

! OE ligature 


! Define lowercase to collate the same as uppercase 

I 

$XE0-%XEF = %XC0-%XCF, 

%XF1-%XFD = %XD1-%XDD ) ); 

1.6.2 Conversion Function Keyword Clauses 

There are three types of keyword clauses you can use to build a conversion 
function: 

• CF 

• IDENT 

• MODIFICATIONS 

Each of these is described in the following subsections. 
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1.6.2.1 CF Keyword Clause The CF keyword clause equates the keyword CF to 
a conversion function expression, which can take any one of the forms described 
in Section 1.5. The general form for the CF keyword clause follows: 

CF = CF_expression 

The following example illustrates the use of the CF keyword clause: 

MULTI_TO_NODIACRITICALS = CF( 

IDENT = "VI.0", 

CF = .IDENTITY, 

MODIFICATIONS^ 

%XC0-%XC5 = "A", ! Various forms of "A" assigned same weight 


%XF9-%XFC = "u", ! Various forms of "u" assigned same weight 

%XFD = "y" ) ); ! Y umlaut assigned weight of "y" 

See Section 1.4 for details on the use of the _IDENTITY built-in definition. 

1.6.2.2 IDENT Keyword Clause The IDENT keyword clause is a special-purpose 
keyword clause that permits you to assign a version number to the conversion 
function. The following example illustrates the use of the IDENT keyword clause 
to assign Version 1.0 to a conversion function: 

MULTI_TO_LOWER = CF( 

IDENT = "VI.0", 

CF = .IDENTITY, 

M0DIFICATI0NS=( 

%X41-%X5A = %X61-%X7A, ! Characters A-Z 


%XD1-%XDD = %XF1-%XFD ) ); ! Various characters 

1.6.2.3 MODIFICATIONS Keyword Clause The MODIFICATIONS keyword 
clause is used in conjunction with another conversion function, typically the built- 
in conversion function .IDENTITY, to derive a modified version of the conversion 
function. The MODIFICATIONS keyword clause causes NCS to modify the 
specified conversion function, making changes in the specified order. 

The following example illustrates the use of the MODIFICATIONS keyword 
clause in a conversion function: 

MULTI.TO.UPPER = CF( 

IDENT = "VI.0", 

CF = INVERSE(MULTI.TO.LOWER), 

MODIFICATIONS=(%XDF = "SS", %XD7 = "OE");) 

In this example, the MODIFICATIONS keyword clause masks the lowercase 
sharp s (B) by equating it to the character pair SS and the uppercase OE ligature 
x by equating it to the character pair OE. 

1.6.3 MODIFICATIONS Keyword Clause Syntax 

This section expands on the syntax requirements for developing 
MODIFICATIONS keyword clauses in an NCS expression. 

The conversion function MODIFICATIONS keyword clause uses the following 
format: 

left.string = right.string 


NCS-15 







NCS Description 


NCS treats this as left string converts to right string. The following example 
illustrates the use of a MODIFICATIONS keyword clause in a conversion 
function: 


CF = .IDENTITY, 
M0DIFICATI0NS=( 

%X41-%X5A = %X61-%X7A, 


In this example, NCS treats the MODIFICATIONS keyword clause as uppercase 
characters convert to lowercase characters , where the source string is a range 
of hexadecimal numbers representing uppercase alphabetic characters and the 
destination string is a range of hexadecimal numbers representing lowercase 
alphabetic characters. 

Note that the equal sign (=) is always the sign of operation for conversion 
function MODIFICATIONS keyword clauses. 

The various formats for the collating sequence MODIFICATIONS keyword clause 
are listed in Table NCS-2. 


Table NCS-2 Formats for Collating Sequence MODIFICATIONS Keyword 
Clauses 

Format Interpretation 


string = string 
range = string 
range = range 
string > string 
range > string 
range > range 
string < string 
range < string 
range < range 


left string collates as right string 

left range collates as right string 

left range collates as right range 

left string collates just greater than right string 

left range collates just greater than right string 

left range collates just greater than right range 

left string collates just less than right string 

left range collates just less than right string 

left range collates just less than right range 


You can specify a range of values in a keyword clause, using the following format: 
stringl - string2 

The following example shows how to assign the left string the same collating 
value as the right string: 

CS = .NATIVE * ( MULTI.TO.NODIACRITICALS * MULTI.TO.UPPER ), 
MODIFICATIONS=( 

%XDF = "SS\ 
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The MODIFICATIONS keyword clause in this example states that the 
hexadecimal value for S sharp (%XDF) has the same collating value as SS. 

The next example shows various source strings being assigned collating values 
that are relatively greater than, less than, and equal to the destination strings: 


MODIFICATION ( 


%XDF > "S\ 

%XD7 < "0", 

%XF7 = %XD7 ) ); 


S sharp 
OE ligature 
oe ligature 


Here the hexadecimal value for S sharp collates just greater than the letter S, 
the hexadecimal value for the uppercase x ligature collates just less than the 
letter O, and the hexadecimal value for the lowercase -r ligature collates equal to 
uppercase x. 

You can also assign a range of strings the same collating value as a single string. 
For example, if you want to assign all of the lowercase alphabetical characters the 
same collating weight as a null character that typically has the lowest collating 
value in a set, you would state it as follows: 


CS = .NATIVE 

MODIFICATIONS^( 


%X61-%X7A = %X00, 


In building a definition file, you can compose a definition that is not compatible 
with NCS because the function is not well defined or because of some restriction 
NCS may impose on the function. In analyzing a definition, use the NCS 
/EXTRACT command to retrieve the function (see Part II). The NCS/EXTRACT 
command restructures the definition in its most basic form. The resulting 
definition may not be as efficient as the original definition but it is generally 
more logically structured and easier to read. 
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_ Part II 

NCS Command and Command Qualifiers 


This part of the document describes the NCS command and its qualifiers. 











NCS Usage Summary 


The NCS command invokes the National Character Set (NCS) Utility, which 
performs NCS library functions specified by NCS qualifiers. By default, NCS 
tries to replace the definition modules in the default NCS library with the 
definitions in the specified input file. All other NCS library functions require 
explicit command qualifiers. 

PARAMETER 

NCS [input-filespec] 

Parameter 

[input-filespec,...] 

Where applicable, specifies the name of one or more input files containing 
definitions that NCS is to use to perform the action specified by the command 
qualifier. By default, NCS attempts to replace modules in the default NCS library 
with definitions in the input file. 

You must specify an input file when you want to either replace or insert a module 
in the specified NCS library. Specifying an input file is optional when you want 
to create a new library. 

If you specify several input files, you must separate them with commas (,). The 
default file type for input files is NCS. 

usage summary 

Invoke the NCS Utility by entering the DCL command NCS. The NCS Utility 
exits when the specified command operations are completed. If you use the /LIST 
qualifier, you can direct output to a specified file. If you do not specify a file, the 
output is directed to SYS$OUTPUT. 
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NCS Command Qualifiers 

You may use one qualifier, no qualifiers, or several qualifiers with the NCS 
command, depending on the library functions you want to perform. Most of the 
qualifiers are compatible with one another and some require that you enter a 
related qualifier to do a specific task. 

Table NCS-3 lists qualifiers that require a related qualifier and qualifiers that 
are incompatible. 


Table NCS-3 NCS Command Qualifier Relationships 


Qualifier 

Related Qualifiers 

Incompatible Qualifiers 

/BEFORE 2 

/LIST 


/COMPRESS 

/OUTPUT, /LIBRARY 

/CREATE, /EXTRACT 

/CREATE 1 

/LIBRARY 

/COMPRESS, /EXTRACT 

/DATA 

/COMPRESS, CREATE 

/EXTRACT, /INSERT, /REPLACE 

/DELETE 

/LIBRARY 

/CREATE, /EXTRACT 

/EXTRACT 

/LIBRARY, /MACRO, /OUTPUT 

/COMPRESS, /CREATE, /DELETE 

/FORMAT 3 

/MACRO 


/FULL 2 

/LIST 


/HISTORY 2 

/LIST 


/INSERT 

/LIBRARY 

/EXTRACT 

/LIBRARY 

COMPRESS, /CREATE, 
/DELETE, /EXTRACT, /INSERT, 
/LIST, /REPLACE 


/LIST 

/BEFORE, /FULL, /HISTORY, 
/LIBRARY, /ONLY, /SINCE, 

/EXTRACT 

/LOG 

/CREATE, /DELETE, 

/EXTRACT, /INSERT, 

/REPLACE 


/ONLY 2 

/LIST 


/OUTPUT 

/EXTRACT 

/DELETE 

/REPLACE 

/LIBRARY 

/EXTRACT 

/SINCE 2 

/LIST 


lr The /CREATE, /INSERT, and /REPLACE qualifiers are compatible but /CREATE takes precedence. The related 
qualifiers for /CREATE are applicable only if you enter one or more input files. 

2 This qualifier is meaningful only when used with the /LIST qualifier. 

3 This qualifier is meaningful only when used with the /MACRO qualifier. 
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NCS Qualifiers 
/BEFORE 


/BEFORE 


Lists only the modules inserted in the library before the specified time. 


Format 

/BEFORE[= time] 

Qualifier Value 

time 

The time (and date, where applicable) that NCS uses as the reference cutoff point 
for accumulating the appropriate list of modules. 

Description 

When you use the /LIST qualifier, NCS lists all the definitions in the NCS library 
by default. However, you can use the /BEFORE qualifier with the /LIST qualifier 
to list only definitions created before a specified time (and date, where applicable). 
You may specify an absolute time or a combination of absolute time and delta 
time. For details on specifying times, see the OpenVMS DCL Dictionary. 

If you use the /BEFORE qualifier without specifying the time, the output list 
includes all definitions in the library created before today. 

Examples 


1. $ NCS/LIST/BEFORE=31-DEC-1988:13:30 

This command lists all definition modules inserted in the default NCS library 
before 1:30 p.m. on December 31, 1988. 

2. $ NCS/LIST/BEFORE=31-DEC-1988:09:00/LIBRARY=USERDISK:[DOE]LIB.NLB 

This command lists all definition modules inserted in user DOE’s local NCS 
library, LIB.NLB, before 9:00 a.m. on December 31, 1988. 
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/COMPRESS 


/COMPRESS 


Recovers disk space previously occupied by deleted definition modules. 


Format 

/COMPRESS[=(option[,...])] 


Qualifier Value 


option 

A set of options that permits you to change the size or format of the specified 
library, overriding the values assigned to the library when it was created. See the 
listing under DESCRIPTION. 


Description 

The /COMPRESS qualifier effectively recovers disk space previously occupied by 
modules deleted from an NCS library by creating a more efficiently organized 
output library file. If you do not explicitly specify a destination library, NCS 
creates a new compressed version of the default NCS library. When you compress 
an NCS library, you can override various NCS default values for the size and 
format of the library, using the following options: 


BLOCKSm 

HISTORYm 

KEYSIZE:n 

MODULESm 


Specifies the number of 512-byte blocks to be allocated for 
the library. By default, NCS allocates 100 blocks for a new 
library. 

Specifies the maximum number of library update history 
records that the library may maintain. By default, NCS sets 
the number at 20. 

Changes the maximum length of definition module names. 

Specifies the maximum number of modules in the NCS 
library. 


Examples 


1. $ NCS/C0MPRESS=(BLOCKS:200)/LIBRARY=USERDISK:[DOE]LIB.NLB 

T his command compresses user DOE’s local NCS library and simultaneously 
allocates two hundred 512-byte blocks for it. 

2. $ NCS/COMPRESS=(KEYSIZE:35(MODULES:40)/LIBRARY=USERDISK:[DOE]LIB.NLB 

This command compresses user DOE’s local NCS library and specifies a 
maximum key size of 35 bytes together with a maximum of 40 definition 
modules. 


NCS-24 




NCS Qualifiers 
/CREATE 


/CREATE 


Creates an NCS library. 


Format 


/C RE ATE[=(option[,...])] 

Qualifier Value 

option 

A set of options that permits you to override the system defaults for the size and 
format of the newly created NCS library. See the listing under DESCRIPTION. 


Description 


Use the /CREATE qualifier to create an NCS library. Note that you must use 
the /LIBRARY qualifier and explicitly specify the device and directory when you 
create a new NCS library (See examples). If you do not specify a device and 
directory in the command line, NCS creates the library in SYS$LIBRARY by 
default. If you do not use the /LIBRARY qualifier to specify a new library, NCS 
creates a new version of the default NCS library. 

To populate the new library from an existing definition file, enter as the command 
parameter the specification for the input file containing the definitions. 

When you create an NCS library, you can override various NCS default values for 
the size and format of the library, using the following options: 

BLOCKS:n Specifies the number of 512-byte blocks to be allocated for 

the library. By default, NCS allocates 100 blocks for a new 
library. 


HISTORYn 

KEYSIZEm 

MODULES:n 


Specifies the maximum number of library update history 
records that the library may maintain. By default, NCS sets 
the number to 20. 

Changes the maximum length of definition module names. 

Specifies the maximum number of modules in the NCS 
library. 


Examples 

1. $ NCS/CREATE=(BLOCKS:200,KEYSIZE:24)/LIBRARY=DISK1:[DOE]LIB.NLB 

This command creates a file named LIB.NLB in the directory DOE, while 
simultaneously allocating the file 200 blocks and setting the maximum 
module name length at 24 characters. 

2. $ NCS/CREATE=M0DULES:40/LIBRARY=USERDISK:[DOE]ABC.NLB MY.NCS 

This command creates an NCS library in directory DOE named ABC.NLB. 
The command limits the library to 40 modules and populates it with 
definitions from input file MY.NCS. 
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/DATA 


/DATA 


Improves disk space efficiency. 


Format 


/DATA= { 


REDUCE 

EXPAND 


} 


Qualifier Values 

REDUCE 

Stores definitions in a data-reduced format. 

EXPAND 

Stores definitions in a data-expanded format. 

Description 

The /DATA qualifier gives you the option of specifying how you want definitions 
stored in the NCS library, in data-reduced format or data-expanded format. Note 
that you must specify a value, either REDUCE or EXPAND, with this qualifier; 
there is no default value. Note, too, that NCS does an implicit compression 
(recovers unused space from previously deleted files) on the specified library, 
whether you are converting the library to data-reduced form or to data-expanded 
form. 

If the specified NCS library is in standard (nonreduced) form, use the REDUCE 
option to create a new reduced version of the library. If you do not use the 
/LIBRARY qualifier to specify a library, NCS creates a new reduced version of 
the default NCS library. Note that access to libraries in data-reduced format is 
generally slower than libraries in data-expanded format. 

If the specified NCS library is in reduced form, use the EXPAND option to create 
a new expanded (standard) version of the library. If you do not use the /LIBRARY 
qualifier to specify a library, NCS creates a new expanded version of the default 
NCS library. Note that access to libraries in data-expanded (standard) format is 
generally faster than libraries in data-reduced format. 

Examples 

1. $ NCS/DATA=REDUCE 

This command maximizes the space efficiency of the default NCS library. 

2. $ NCS/DATA=EXPAND SYS$LIBRARY:NCS$LIBRARY 

This command reduces the access time to and space efficiency of the default 
NCS library. 
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/DELETE 


/DELETE 


Deletes one or more definition modules from the NCS library. 


Format 

/DELETE=module[,...] 

Qualifier Value 

module 

The name of the module to be deleted. 

Description 

The /DELETE qualifier deletes the specified definition module or modules from 
an NCS library. If you specify several modules, separate the definition names 
with commas (,) and enclose the list in parentheses. You may use the standard 
VMS wildcard characters to specify the modules to be deleted. 

If you use this qualifier with the /LIST qualifier, NCS deletes the module before it 
lists the contents of the library. Therefore, the deleted definitions do not appear 
in the output listing. 

Examples 

1. $ NCS/DELETE=CH* 

This command deletes all NCS library modules that begin with the letters 

CH. 

2. $ NCS/DELETE=(LOWER_TO_UPPER,CHANGECASE)/LIST 

This command deletes the definition CHANGECASE from the default NCS 
library and then lists the remaining definitions. 
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NCS Qualifiers 
/EXTRACT 


/EXTRACT 


Extracts definitions from an NCS library. 


Format 


/EXTRACT=module[,...] 


I /OUTPUT= filespec 
\ /MACRO= filespec 


} 


Qualifier Value 

module 

The name of the module to be extracted. 


Description 

The /EXTRACT qualifier is used to retrieve one or more definition modules from 
an NCS library. Note that you must use either the /OUTPUT qualifier or the 
/MACRO qualifier with the /EXTRACT qualifier to specify a destination file for 
the extracted definition. 

Use the /EXTRACT qualifier with the /MACRO qualifier to extract one or more 
definitions that you want to include in a MACRO-32 program file. When you use 
the /MACRO qualifier with the /EXTRACT qualifier, the default output file type 
is MAR. 

Use the /EXTRACT qualifier with the /OUTPUT qualifier to extract one or more 
definitions that you want to include in an NCS definition file. When you use the 
/OUTPUT qualifier with the /EXTRACT qualifier, the default output file type is 
NCS. 

If you want to extract several modules, separate the module names with commas 
(,) and enclose the list in parentheses. 

You may use any of the standard VMS wildcard characters to specify the modules 
to be extracted. 

Examples 


1. $ NCS/EXTRACT=CHANGECASE/MACRO=MY 

This command extracts the definition CHANGECASE from the default NCS 
library and converts it to MACRO format before storing it in the file MY.MAR. 

2. $ NCS/EXTRACT=(CHANGECASE,UPPER_TO_LOWER)/OUTPUT=MY 

This command extracts two definitions from the default NCS library and 
stores them in the definition file MY.NCS. 
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/FORMAT 


/FORMAT 


Specifies the MACRO format appropriate to your program. 

Format 


/FORMAT= { NCS } 
l 256 J 

Qualifier Values 

NCS 

MACRO-32 format for NCS routines. 

256 

MACRO-32 format for the Run-Time Library routine LIB$MOVTC. 


Description 

Use the /FORMAT qualifier with the /MACRO qualifier to specify the appropriate 
MACRO-32 file format. You may select one of two format options, either NCS (the 
default) or 256. If you select the NCS format, NCS formats the collating sequence 
and string conversion tables, or both, for use by the NCS routines. If you select 
the 256 format, NCS formats the collating sequence and string conversion tables, 
or both, as 256-byte tables that can be used by the Run-Time Library routine 
LIB$MOVTC. For more information, see the OpenVMS RTL Library (LIB$) 
Manual. 

Examples 

1. $ NCS/EXTRACT=UP_DOWN/MACRO=MY/F0RMAT=2 5 6 

This command extracts the definition UP_DOWN from the default NCS 
library and converts it to the 256-byte table format before including it in the 
file MY.MAR. 

2. $ NCS/EXTRACT=(ABCDE,XYZ)/MACRO=MY 

This command extracts two definitions from the default NCS library and 
converts them, by default, to NCS format before including them in the file 
MY.MAR. 
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NCS Qualifiers 
/FULL 


/FULL 


Provides a complete listing of an NCS library. 


Format 

/FULL 


Parameters 

None. 

Description 

Use the /FULL qualifier with the /LIST qualifier to obtain an NCS library listing 
that includes the date and time each module was inserted into the library. The 
output has the following format: 

module inserted dd-mmm-yyyy hh:mm:ss 

Example 

$ NCS/LIST/FULL 

This command lists the modules in the default NCS library, together with the 
date and time that each module was inserted into the library. 
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NCS Qualifiers 
/HISTORY 


/HISTORY 

Provides the update history record headers for the NCS library. 

Format 

/HISTORY 

Parameters 

None. 

Description 

You use the /HISTORY qualifier with the /LIST qualifier to obtain a list of the 
update history record headers for the specified NCS library, in the following 
format: 

username operation n modules on dd-mmm-yyyy hh:mm:ss 

The operation may be a replacement, insertion, or deletion of definition modules. 

If you specify the /FULL qualifier with the /HISTORY and /LIST qualifiers, 
NCS lists the history record headers for each update, together with a list of the 
definition modules affected by each update. 

Examples 

1. $ NCS/LIST/HISTORY 

If you had previously deleted two definition modules from the NCS library, 
this command would produce a listing that includes the following line: 

JONES deleted 2 modules on 31-DEC-1988 16:26:36 

2. $ NCS/LIST/HISTORY/FULL 

Making the same assumptions as in the previous example, this command 
would produce a listing that includes the names of the deleted modules: 

JONES deleted 2 modules on 31-DEC-1988 16:26:36 

CHANGECASE 

UPCASE 
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NCS Qualifiers 
/INSERT 


/INSERT 


Adds one or more definition modules to an NCS library. 


Format 

/INSERT filename 

Parameters 

None. 

Description 

Use the /INSERT qualifier to add one or more definition modules to an NCS 
library from an input file. If the input file contains more than one definition, NCS 
creates a separate entry in the library for each. 

Before NCS inserts a definition into an existing NCS library, it verifies that the 
library does not already contain a definition module having the same name. If 
NCS finds a definition module with the same name, it does not add the new 
definition module to the library, but it does provide an appropriate error message. 

Examples 


1. $ NCS/INSERT MY.DEFS 

This command directs NCS to insert each of the definitions from input file 
MY_DEFS.NCS into the NCS library. 

2. $ NCS/INSERT/LIST/HISTORY/FULL MY_DEFS 

This command directs NCS to insert the definitions from input file MY_ 
DEFS.NCS into the NCS library; then NCS lists the history of each definition 
module in the library, including those inserted by this command. 
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NCS Qualifiers 
/LIBRARY 


/LIBRARY 


Specifies an alternate NCS library. The default NCS library is 
SYS$LIBRARY:NCS$LIBRARY. 

Format 

/LIBRARY= filespec 

Qualifier Value 

filespec 

The alternate NCS library file specification. 

Description 

The /LIBRARY qualifier allows you to specify an NCS library other than the 
default NCS library (SYS$LIBRARY:NCS$LIBRARY). Note if you do not include 
a device and directory when you specify the alternate library, NCS defaults to 
SYS$LIBRARY. The default file type is NLB. 

Examples 


1. $ NCS/INSERT/LIBRARY=USERDISK:[DOE]MY_LIB MY_DEFS 

This command directs NCS to insert definitions from the file MY_DEFS.NCS 
into the NCS library MY_LIB.NLB. 

2. $ NCS/DELETE=UPCASE/LIBRARY=GEN_NCS 

This command directs NCS to delete the module UPCASE from the library 
file SYS$LIBRARY:GEN_NCS.NLB. 
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NCS Qualifiers 
/LIST 


/ LIST 


Lists the contents of an NCS library. 

Format 

/LIST[= filespec] 

/NOLIST 

Qualifier Value 

filespec 

The destination file specification for the list output. 

Description 

The /LIST qualifier allows you to obtain a listing of an NCS library. The optional 
file specification parameter allows you to store the listing in a file. The default 
file type is LIS. If you omit the file specification, NCS directs the listing to 
SYS$OUTPUT. 

You are not permitted to use wildcard characters when specifying the destination 
file. 

Note that when you use the /LIST qualifier in conjunction with qualifiers (such 
as the /DELETE qualifier) that modify the contents of the NCS library, NCS 
creates the listing after the modifications are made. For example, if you delete 
the definition module UPCASE and simultaneously request a listing, the listing 
does not include the UPCASE module. 

Listings can provide various types of information, depending on the qualifiers you 
use with /LIST. Each listing, however, contains at least the following information 
about the library: 

Directory of NCS library library-filespec on dd-mmm-yyyy hh:mm:ss 
Creation date: dd-mmm-yyyy hh:mm:ss Creator: VAX librarian Vnn-nn 
Revision date: dd-mmm-yyyy hh:mm:ss Library format: n.n 
Number of modules: nnn Max. key length: nnn 
Other entries: nnn Preallocated index blocks: nnn 
Recoverable deleted blocks: nnn Total index blocks used: nnn 
Max. update history records: nnn Update history records: nnn 

Examples 


1. $ NCS/LIST 

This command outputs a listing of the definitions in the default NCS library 
to the SYS$OUTPUT device. 

2. $ NCS/LIST=DEFLIST/FULL 

This command outputs a listing of the definitions in the default NCS library 
to a file named DEFLIST.LIS. The listing includes the date each definition 
was inserted in the NCS library. 
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NCS Qualifiers 
/LOG 


/LOG 


Determines whether or not NCS verifies library operations. 

Format 

/LOG 

/NOLOG 

Parameters 

None. 

Description 

Use the /LOG or /NOLOG qualifier to specify whether or not you want NCS to 
confirm the result of a specified operation (such as a replacement, insertion, or 
deletion). By default, NCS does not confirm operations. 

Example 


$ NCS/DELETE=(TJL,RRR)/LOG 

This command directs NCS to delete the definitions TJL and RRR in the default 
NCS library. After deleting the definitions, NCS issues the following messages: 

%NCS-S-DELETED, module TJL deleted 
%NCS-S-DELETED, module RRR deleted 
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NCS Qualifiers 
/MACRO 


/MACRO 

Specifies that the extracted definition table is coded in MACRO-32. 

Format 

/MACRO= filespec 

Qualifier Value 

filespec 

The file specification for the destination MACRO file. 


Description 

Use the /MACRO qualifier with the /EXTRACT qualifier if you want to retrieve 
a definition module from the NCS library, convert the definition to VAX MACRO 
format, and then output the VAX MACRO-formatted definition to the specified 
destination file. Note that each collating sequence and conversion function bears 
a global label that you can use to pass the address of the definition to an NCS 
routine. 

You must include the destination file specification with the /MACRO qualifier. 
You cannot use wildcard characters to specify the destination file. The default 
value for MACRO-32 files generated by the /MACRO qualifier is MAR. 

Note that you can further define a specific MACRO-32 format with the /FORMAT 
qualifier, as shown in the second example. 


Examples 


1. $ NCS/EXTRACT=DOWNCASE/MACRO=MY_MACRO 

This command directs NCS to extract the definition DOWNCASE from the 
default NCS library, convert the definition to VAX MACRO format, and then 
output it to file MY_MACRO.MAR. The following example shows an NCS 
definition module converted to VAX MACRO: 

.PSECT NCS$RO_DATA NOVEC,NOWRT,RD,NOEXE,SHR,LCL,REL,CON,PIC,LONG DOWNCASE:: 

.LONG A X00000158, A X00000000, A X00000000, A X00000000 
.LONG A X00000000, A X776F6408, A X7361636E, A X00000065 
.LONG A X00000000, A X00000000, A X00000000, A X00000000 
.LONG A XOOOOOOOO, A XOOOOOOOO, A XOOOOOOOO, A XOOOOOOOO 
.LONG A X0000OO05, A X00000158, A X00000000, A X00000OOO 
.LONG A X00000000 
.LONG A X00000000 

.LONG A X03020100, A X07060504, A XOBOA0908, A XOFOE()DOC 
.LONG A X13121110, A X17161514, A X1B1A1918, A X1F1E1D1C 


.LONG a X23222120, a X27262524, a X2B2A2928, a X2F2E2D2C 
.LONG A X33323130, A X37363534, A X3B3A3938, A X3F3E3D3C 
.LONG A X63 62 6140, A X67 666564, A X6B6A69 68, A X6F6E6D6C 
.LONG A X73727170, A X77767574, A X5B7A7978, A X5F5E5D5C 
LONG A X63626160, A X67666564, A X6B6A6968, A X6F6E6D6C 
.LONG A X73727170, A X77767574, A X7B7A7978, A X7F7E7D7C 
.LONG A XF3F2F1F0, A XF7F6F5F4, A XFBFAF9F8, A XFFFEFDFC 
.END 
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NCS Qualifiers 
/MACRO 


2. $ NCS/EXTRACT=DOWNCASE/MACRO=MY_MACRO/F0RMAT=2 5 6 

This command directs NCS to extract the DOWNCASE definition from 
the default NCS library, as in the first example. However, this command 
explicitly specifies that NCS convert the definition to the MACRO-32 format 
for use with the Run-Time Library routine LIB$MOVTC instead of the default 
NCS format. The following example illustrates the converted definition: 

•PSECT NCS$RO_DATA NOVEC,NOWRT,RD,NOEXE,SHR,LCL,REL,CON,PIC,LONG DOWNCASE:: 

•LONG A X03020100, A X07060504, A X0B0A0908, A X0F0E0D0C 
•LONG A X13121110, A X17161514, A X1B1A1918, A X1F1E1D1C 
.LONG A X23222120, A X27262524, A X2B2A2928, A X2F2E2D2C 
.LONG A X33323130, A X37363534, A X3B3A3938, A X3F3E3D3C 
.LONG A X63626140, A X67666564, A X6B6A6968, A X6F6E6D6C 
.LONG A X73727170, A X77767574, A X5B7A7978, A X5F5E5D5C 
.LONG A X63626160, A X67 666564, A X6B6A6968, A X6F6E6D6C 
.LONG A X73727170, A X77767574, A X7B7A7978, A X7F7E7D7C 
.LONG A X83828180, A X87868584, A X8B8A8988, A X8F8E8D8C 
.LONG A X93929190, A X97969594, A X9B9A9998, A X9F9E9D9C 
.LONG A XA3A2A1A0, A XA7A6A5A4, A XABAAA9A8, A XAFAEADAC 
.LONG A XB3B2B1B0, A XB7B6B5B4, A XBBBAB9B8, A XBFBEBDBC 
.LONG A XE3E2E1E0, A XE7E6E5E4, A XEBEAE9E8, A XEFEEEDEC 
.LONG A XF3F2F1D0, A XF7F6F5F4, A XFBFAF9F8, A XDFDEFDFC 
•LONG A XE3E2E1E0, A XE7E6E5E4, A XEBEAE9E8, A XEFEEEDEC 
•LONG A XF3F2F1F0, A XF7F6F5F4, A XFBFAF9F8, A XFFFEFDFC 
• END 
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NCS Qualifiers 
/ONLY 


/ONLY 


Limits the modules being listed. 


Format 

/ONLY=module[,...] 

Qualifier Value 

module 

The module or modules to be listed. 


Description 

Use the /ONLY qualifier with the /LIST qualifier to specify which definition 
modules in the NCS library you want listed. If you specify more than one 
definition module, separate the module names with commas (,) and enclose the 
list in parentheses. 

You may use wildcard characters to specify the definition module(s). 

Example 


$ NCS/LIST/ONLY=(M*,P*) 

This command directs NCS to list only the definition modules that have names 
beginning with the letter M or the letter P. 
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NCS Qualifiers 
/OUTPUT 


/OUTPUT 


Specifies the output definition file. 

Format 

/OUTPUT= filespec 

Qualifier Value 

filespec 

The file specification for the destination file. 

Description 

You use the /OUTPUT qualifier with the /EXTRACT and /COMPRESS qualifiers 
to specify a destination file. 

Use the /OUTPUT qualifier with the /EXTRACT qualifier to specify a file to store 
the definitions extracted from an NCS library. The default file type is NCS. Note 
that the new definition file is not the same as the definition file used to originally 
create the definition. NCS does not store the original definition file, only the 
resultant definition. 

Use the /OUTPUT qualifier with the /COMPRESS qualifier to specify a 
destination library file for the compressed library. If you do not use the /OUTPUT 
qualifier with the /COMPRESS qualifier, NCS puts the compressed library in a 
new version of the default NCS library. The default file type is NLB. 

Examples 

1. $ NCS/EXTRACT=(UPCASE,DOWNCASE)/OUTPUT=USER:[DOE]NEW_DEFS.NCS 

This command directs NCS to extract two definitions (UPCASE and 
DOWNCASE) from the default NCS library and to store them in a file 
named NEW_DEF.NCS. 

2. $ NCS/COMPRESS/OUTPUT=USER:[DOE.NCS]NEW_LIB 

This command directs NCS to compress the default NCS library and to 
store the compressed version in an alternate NCS library specified as 
USER: [DOE .NCS] NE W_LIB .NLB. 
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/REPLACE 


/REPLACE 


Replaces one or more definition modules in the default NCS library with modules 
from the specified input file. 


Format 

/REPLACE 

Parameters 

None. 

Description 

Use the /REPLACE qualifier when you want to replace one or more library 
modules with definitions from the specified input file. If a replacement module 
in the input file does not have a corresponding module in the NCS library, 

NCS inserts, rather than replaces, the new module in the library. If you do not 
explicitly specify a qualifier for the NCS command, the default is the /REPLACE 
qualifier. 

Example 

$ NCS MY.DEFS 

This command directs NCS to replace each definition in the default NCS library 
with a corresponding definition from the input file, MY_DEFS.NCS. 
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NCS Qualifiers 
/SINCE 


/SINCE 


Limits a library output listing to definitions inserted after the specified date and 
time. The most recent definitions are listed first, and are in alphabetical order. 


Format 

/SINCE[= time] 

Qualifier Value 

time 

The time (and date, where applicable) that NCS uses as the reference point to 
begin accumulating the appropriate list of modules. 

Description 

Use the /SINCE qualifier with the /LIST qualifier to list only modules inserted 
into the library after the specified time (and date, where applicable). You can 
specify an absolute time or a combination of absolute and delta times. For details 
on specifying times, see the OpenVMS DCL Dictionary. 

If you omit the /SINCE qualifier, NCS lists all the modules in the library unless 
you use a different limiting qualifier (/BEFORE or /ONLY). If you specify the 
/SINCE qualifier without a time or date, NCS lists only the modules inserted 
today. 

Examples 

1. $ NCS/LIST/SINCE=31-DEC-1988:10:00 

This command directs NCS to list only modules inserted in the default NCS 
library after 10 a.m. on December 31, 1988. 

2. $ NCS/LIST/SINCE 

This command directs NCS to list only modules inserted in the default NCS 
library today. 
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National Character Set Definitions 


This appendix lists the contents of the default NCS library (NCS$LIBRARY). The 
library includes 13 collating sequences and 24 conversion functions. 


Danish = CS( 

SEQUENCE = (%X00-"N" / "N", "0"-"Z", "A", "0", "A", »{»_»£» # %XDO, 

%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A" - " Z " , "A"-"A" = "A", "A" = "A", "Q" = "C" 

= "E", = "i", = "0", "0" = "0", = »u\ 

"U"-"Y" = "Y", " a" -" a" = "A", ,, a"-"A" = ,, a ,, -"A" , "ae" = "A", "<p" = "C" 

^e" = "E", "i"-"I" = "i", "ft" = "N", " 6 "-" 6 " = "0", " 6 " = "0", 

” 0 " = "0", ,, u"-"u" = "U", "u"-"y" = "Y", "OE" = "OE", "g" = "SS\ 

"<E" = "CE", "" < %X00) ) 

+ CS ( SEQUENCE = (%XOO-"A" / "A" - "A" , "B"-"C", "Q", "D"-"E", ,, E"-"E", 

"J"-”N", "N", "CE", "0", "d”-"d", "P"-"R" ( "g", 
"S"-"U", "U"- ,, U", "V"-"Y", "Y", "Z", "M", "0", "A", " {"-"c", 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "a"-"I" = "A"-"!", "n"-"y» = n N"_"Y")) 

+ REVERSE(.NATIVE); 


ZK-6574-GE 


Danish_NRC_to_Multi = CF( 
CF = .IDENTITY, MODE = 
= "A", 

"[" = "M", 

"\" = " 0 ", 

"]" = "A", 

H A || _ II 0 II ^ 



H ^ II _ II -Q II 

"" = %X00)); 


( 
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National Character Set Definitions 


Dutch = CS( 

SEQUENCE = (%X00-"N", "N", "0"- 

%XDE, %XF0, %XFE-%XFF), 
M0DIFICATI0NS=("a"-"z" = "A"-"Z 
= "i", "6"-"6" = 
"A"-"*" = "A"-"-®", "q" = 
"6"-"o" = "0", "0" = "0", 


"Z", "A", "0", "A”, 


"{"-"c"/ %XD0, 



"g" = "SS”, "as" = "CE", "" < %X00)) 

+ CS( SEQUENCE = (%XOO-"A", "A"-"A", "B"-"C", "Q", "D"-"E 
»F"-"I", " I" - 11 1" , " J"-"N" , "N" , "CE", "0", "0"-"0", 
"S"_"U", "U"-"U", "V"-"Y", "Y", "Z", "M", "0", "A", 
%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS^"a"-"z” = "A"-"Z”, = "A"-"!", "n"- 

+ REVERSE(_NATIVE); 


II II g II _ II g II 

"P"-"R", "E" , 

"y" = "N" -"Y")) 
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National Character Set Definitions 


EDT_VT2xx = CF( 

CF = .IDENTITY, MODI = ( 
%X00 - " A @", 

%X01 = " A A\ 

%X02 = " A B", 

%X03 = " A C", 

%X04 = " A D", 

%X05 = " A E\ 

%X06 = " A F", 

%X07 = " A G", 

%X08 = " A H", 

%X0A = "<LF>", 

%X0B = "<VT>", 

%X0C = "<FF>", 

%X0D = "<CR>", 

%X0E = " A N", 


%X0F = " A 0\ 
%X10 = " A P", 
%X11 = " A Q", 


%X12 

= 

" A R", 

%X13 

= 

" A S\ 

%X14 

= 

" A T\ 

%X15 

= 

" A U", 

%X16 

= 

" A V", 

%X17 

= 

" A W", 

%X18 

= 

HA X", 

%X19 

= 

" A Y " / 

%X1A 

= 

" A Z", 

%X1B 

= 

"<ESC>' 

%X1C 

= 

" A \\ 

%X1D 

= 


%X1E 

= 

" AA ", 

%X1F 

= 

" A _", 

%X7F 

= 

”<DEL>' 

%X80 

= 

"<X80>" 

%X81 

= 

"<X81>" 

%X82 

= 

"<X82>" 

%X83 

= 

"<X83>" 

%X84 

= 

"<IND>" 

%X85 

= 

"<NEL>" 

%X86 

= 

"<SSA>" 

%X87 

= 

"<ESA>" 

%X88 

= 

-<HTS>" 

%X89 

= 

"<HTJ>" 

%X8A 

= 

"<VTS>" 

%X8B 

= 

"<PLD>" 

%X8C 

= 

"<PLU>" 

%X8D 

= 

"<RI>", 

%X8E 

= 

"<SS2>" 

%X8F 

= 

"<SS3>" 

%X90 

= 

"<DCS>" 

%X91 

= 

"<PU1>" 

%X92 

= 

"<PU2>" 

%X93 

= 

"<STS>" 

%X94 

= 

"<CH>", 

%X95 

= 

"<MW>", 

%X96 

= 

"<SPA>" 

%X97 

= 

"<EPA>" 

%X98 

= 

"<X98>" 

%X99 

= 

"<X99>" 

%X9A 

= 

"<X9A>" 

%X9B 

= 

"<CSI>" 

%X9C 

= 

"<ST>", 

%X9D 

= 

"<OSC> H 

%X9E 

= 

"<PM>", 

%X9F 

= 

"<APC>" 

%XA0 

= 

”<XA0>" 

%XA4 

= 

"<XA4>" 

%XA6 

= 

"<XA6>" 

%XAC 

= ' 

"<XAC>" 

%XAD 

= 1 

"<XAD>" 

%XAE 

= 1 

"<XAE>" 

%XAF 

= 1 

"<XAF>", 

%XB4 

= 1 

"<XB4>", 

%XB8 


"<XB8>", 

%XBE 


'<XBE>“, 

%XD0 


’<XD0>", 

%XDE : 


•<XDE>", 

%XF0 : 


’<XF0>", 

%XFE : 


'<XFE>", 

%XFF i 


'<XFF>", 


"" = %X00)); 
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National Character Set Definitions 


English = CS( 

SEQUENCE = (%X00-"N", "N", "A", "0", "A" 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS= (" a" - " z " = "A"-"Z", "A"-"A" = "A", 

"i"-"1" = "i", = "0", "U"-"U" = "U" 

= "A"-"A", "Q" = "C", "e"-"e" = "E" 


it r ii it / ii 
/ L / 


ii r ii ii . ii 

\ ~ C t 


%XD0, 



" 6 "-" 6 " = " 0 ", " 0 " 


"0", "u"-"u" = "U", "y" = "Y", "CE" = "OE", 


"6" = ”SS", "ce" = "CE", "" < %X00) 

+ CS( SEQUENCE = (%XOO-"A", "A"-"A", "B"-"C 

"J"-"N", "N”, "CE", 

"S"—"U", "U"-"U", "V"-"Y", "Y" , "Z", 
%XDO, %XDE, %XFO, %XFE-%XFF), 
MODIFICATIONS=("a"-"z" = "A"-"Z", "a"-"I" = 
+ REVERSE(_NATIVE); 


ii ii g„ » d " - " E 11 " E ” — 11 E " / 

"0", "0"-"6", "P"-"R", "£>", 
"A", "0", "A", 

"A"-"l", "n"-"y" = "N"-"Y")) 
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Finnish = CS( 

SEQUENCE = (%XOO-"N", "N", "0"-"Z", "O", %XDO, 

%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=(”a"-"z" = "A"-"Z", "A"-"A" = "A", "Q" = "C", "E"- ,, E" = "E", 

= "I", "6"-"5" = "O" , "0" = "0", "U"-"0" = "U", "U"-"Y" = "Y", 
”a"-"a" = "A", "a"-"*" = = "C", "e"-"e" = "E", 

i" —" 5. = "I", "n" = "N", ,, 6"-"o" = "0", "6" = "O", "0" = "0", 

= "U", "u”-"y" = "Y", "CE" = "OE", = "SS", "ce" = "CE", 

"" < %X00)) 

+ CS( SEQUENCE = (%XOO-"A n , "A"-"A", "B"-"C", "C", "D"-"E", "E"-"E", 

»F» —»I", "j"_"x" t "J"-"N", "N", "CE", "0", "6"-"0", "P"-"R“, "E", 

“S"-"U", "U"-"U", "V"-"Y", "Y", "Z", "M", "0", "A", 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a”-"z" = "A"-"Z", = "A"-"l", "n"-"y" = "N"-"Y")) 

+ REVERSE(_NATIVE); 
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Finnish_NRC_to_Multi = CF( 

CF = _IDENTITY, MODI = ( 
"[" = "A" , 


"\" = "O", 



"" = %X00)); 
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National Character Set Definitions 


FrCan_NRC_to_Mu1ti 
CF = _IDENTITY, 
= "a", 

"\" = " r" . 



= "u" ( 

"" = %X00)) 


= CF ( 
MODI 


( 
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French = CS( 

SEQUENCE = (%X00-"N" ( "N", "0"-"Z", "A", "0", "A", %XD0, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS= ( "a"-"z" = "A”-"Z", "A"-"A" = "A", "Q" = "C" , " E" -" E" = "E", 

= "I", "6"-"0" = "O", "U"-"U" = "U", "Y" = "Y", "a"-"a" = "A", 
= "A" -"A", n Q« = "C\ "e"-"e" = "E", "i"-"!" = "I", "n" = "N", 
" 6 "-" 6 " = "0", " 0 " = "0", "u"-"u" = "U", "y" = "Y", "CE" = "OE", 

" 6 " = "SS", "<e" = "CE", < %X00)) 

+ CS( SEQUENCE = (%XOO-"A" / "A"-"A", , "Q", "D"-"E", "E"-"E", 

"F"-"I", "I"-"I", "J"-"N" , "N", "CE" , "0", " 6 ""P"-"R", " 6 ", 

"S"-"U", "U"-"U", "V"-”Y", "Y", "Z", "iE", "0", "A", 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", “a"-"I" = "A"-"I", "n"- M y" = "N"-"Y")) 

+ REVERSE(-NATIVE); 

ZK-6583-GE 


French_NRC_tO—Multi = CF( 

CF = -IDENTITY, MODI = ( 



"~u" = “u", 

"" = %X00)); 

ZK-6584-GE 
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National Character Set Definitions 


German = CS( 

SEQUENCE = (%X00-"N", "N" , "0"-"Z" ( "R" , "0", "A", %XD0, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS= (" a" -" z" = "A"-"Z", "A"-"A" = "A", "Q" = "C", "E"-"E" = "E", 

m j i. _" j" _ i>i» ( - iiq", "u»_"u" = "U", "Y" = "Y", "a"-"a" = "A", 

"A"-"ae" = "A"-"R", "<?" = "C", "e n -"e" = "E", = ”1", "ft" = "N", 

»o"-"o" = "0", "0" = "0", "u"-"u" = "U", "y" = "Y", "CE" = "OE", 


"6" = "SS", "ce" = "CE", "" < %X00)) 

+ CS( SEQUENCE = (%XOO-"A", "A"-"A", "B"-"C 
p " - " I" , " J"-"N" , "N" , "CE", 

"S"-"U", "U"-"U", "V"-"Y", "Y", "Z", 
%XDO, %XDE, %XFO, %XFE-%XFF), 
MODIFICATIONS=("a"-"z" = "A"-"Z", = 

+ REVERSE(_NATIVE); 


II II Q II II Q II _ II g II II gll _ II g" 

„0„, "P"-"R", "6", 

"A", "0", "A", 


ii ii __ ii J li ii ^i^iiyii _ I' H _ M Y n ) ) 


ZK-6585-GE 


German_NRC_to_Multi = CF( 

CF = .IDENTITY, MODI = ( 
_ ..§» t 
"[" = "A", 

„\„ _ »0", 

"]" = "U", 

"{" = "a", 

"|" = " 6 ", 

"}" = "ii", 

it_ ii _ ii ii 

"" = %X00)); 

ZK-6586-GE 


Italian = CS( 

SEQUENCE = (%XOO-”N", "N", "0"-"Z", "A", "0" 
%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "A"-"A" = 
"i"-"i" = ”i”, "6"-"0" = "0", "U"-"U" 

= "h"-"R", "cp" = "C", "e"-"e" 



-" 6" 


"0", "0" = "0", "u"-"u" = "U", "y" 


"Y", "CE" 


"OE", 


= "SS", "ce" = "CE", "" < %X00)) 

+ CS( SEQUENCE = (%XOO-"A", "A"-"A", "B"-"C 
F " - " I" , "l"-"i", " J"-"N" , "N" , "CE", 
ii cj m _" u n "U M — 11 U" "V" — "Y", "Y" f n z 11 , 

%XDO / %XDE, %XFO, %XFE-%XFF), 
MODIFICATIONS= ("a"-"z" = "A ,, - ,, Z", "a"-"!" = 
+ REVERSE (_NATIVE); 


", "C", "D"- ,, E", 


"E 


E", 



"0", "A", 



"A"-"l", "n"-"y" 


„N"-"Y") ) 


c 


ZK-6587-GE 


A-6 












National Character Set Definitions 


Ita1ian_NRC_to_Mu1ti = CF( 

CF = _IDENTITY ( MODI = ( 


II |- II 
II \ II 


II J II 
II / II 
II { II 
II | II 
II j II 

II_II 

II II _ 


" £" < 

ii O ii 

ii n ii 
V / 

"e", 


_ ii ii 

/ 

%X00)); 


ZK-6588-GE 


Multinational = CS( 

SEQUENCE = (%X00-"N", "ft", "A", "0", "A", %XD0, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "A"-"A" = "A", "Q" = "C”, "E"-"E" = "E" 

"I"-"I„ = "I", "d"-"0" = "O", "U"-"U" = "U", "Y" = "Y", "a"-"a" = "A", 
"A"-"ae" = "A"-"A", "g" = "C\ "e”-"e” = "E\ "i"-"i" = "I", "n" = »ft"' 
" 6" -" 6 11 = "0", "®" = "0", "u"-"u" = "U", "y" = "Y'\ "CE" = "OE", 

“£" = "SS", "as" = "CE”, < %X00)) 

+ CS( SEQUENCE = (%XOO-"A" / "A"-"A", "B"-"C", "Q", "D"-"E", "E"-"E" / 

.. p_ I. J „ r "I" —i", " J"-"N", "N" , "CE", "0", "0"-"6", " p " — " R", "£» # 
"S"-"U" , "U"-"U" , "V"-"Y", "Y", "Z", "A", "0", "A", 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "a"-"I" = "A"-"l", "n"-"y" = "N"-"Y")) 

+ REVERSE(_NATIVE); 


ZK-6589-GE 


Multinational^ = CS( 

SEQUENCE = (%XOO-"N", "N", " 0" - " Z", "A", "0", "A", / " / "{»_»£», %XDO 

%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS^("a"-"z" = "A"-"Z", "A"-"A" = "A", "Q" = "C", "E"-"E" = "E" 

= "I", "6"-"0" = "0", "U"-"U" = "U", "Y" = "Y'\ "a"-"a" = "A", 
"A"-"*" = "A"-"A", "g" = "C" , = "E", = "i", "n" = "ft", 

" 6 "-"6" = "0", "0" = "0", "u"-"u" = "U", "y" = "Y", "CE" = "OE", 

"£" = "SS", "as" = "CE", "" < %X00)) ; 

ZK-6590-GE 


Multinational_2 = CS ( 

SEQUENCE = (%XOO-"A", "A"-"A", "B"-"C 
" 1" -" I", " J"-"N" , "N", "CE", “0" 
, “V"-"Y", "Y", "Z", "AE 
%XDE, %XF0, %XFE-%XFF), 
MODIFICATIONS=("a"-"z" = "A"-"Z", "a"- 
"" = %X0 0)); 


, " Q" / 11 d " —" E 11 , " E " - ” E 11 " p m _ H j H 

"0"-"6", "p"_" r " t »g»/ "S"-"u ,, , , 

, "0", "A", %XDO, 

"I" = "n"-"y" = "N"—"Y", 

ZK-6591-GE 
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National Character Set Definitions 


Multi_to_Danish_NRC = CF( 
CF = _IDENTITY, MODI = 
"A" = 

"A" = "]", 

"M" = 


"0" = "V, 



II -Q II _ II ^ II 

= %X00) ) ; 


( 


ZK-6592-GE 


Multi_to_Finnish_NRC = CF( 

CF = -IDENTITY, MODI = ( 

-A" = "[", 

"A" = "]", 

" 0 " = "\“, 

" U 11 = " ^" 



II -Q " _ II ^ II 

"" = %X00)); 

ZK-6593-GE 

Multi—tO—FrCan—NRC = CR( 

CF = -IDENTITY, MODI = ( 
"a" = , 

-t" = “[", 



II ^ II _ II A II 


"U" = "I", 

"u" = , 

= %X00) ) ; 

ZK-6594-GE 
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National Character Set Definitions 


Multi_to_French_NRC = CF( 

CF = .IDENTITY, MODI = ( 



mOh _ ii f » 



"6" = "~o", 

"G" = " A U", 

"ii" = "~u", 

"" = %X00)); 

ZK-6595-GE 

Multi_to_German_NRC = CF( 

CF = -IDENTITY, MODI = ( 

" §" = " @ , 

"A" = " [ ••, 

" 0 " = "\" , 

"U" = "]", 



" = %X00)); 

ZK-6596-GE 


Multi—to_Italian.—NRC = CF( 

CF = -IDENTITY, MODI = ( 

ii £ ii = ii ^ ii 

"§" = , 
ii O ii _ H f ii 


a" = "{ 



- , 

= %X00) ) ; 

ZK-6597-GE 
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National Character Set Definitions 


Multi_to_Lower = CF( 

CF = _IDENTITY, MODI = ( 
" " __» 2 M = "a"-"z", 

"N"-''Y" = "n"-"y", 

= %X00)); 

ZK-6598-GE 


Multi_to_NoDiacriticals = CF( 
CF = -IDENTITY, MODI = ( 
"A" -"A" = "A", 


iigu _ hq it 



"N"-"6" = "N"-"0", 

= "O", 

" 0 " = " 0 ", 

„U„-"U" = "U", 

H y" — ii y" 

„a"-"a" = "a", 

II g, II _ H Q H 

II ^ II _ II 0 II _ H 0 II 

ii ^ ii _ ii 2^ ii _ ii ^ ii 

"n"_"6" = "n"-"o", 
"6"-"6" = "o", 

"u'.-"u" = "u", 

"y" - "y", 

"R" = "AE" , 

"CE - "0E", 

"£>" = "ss", 

"ae" = "ae", 

"ce" = "oe", 

"" = %X00)); 

ZK-6599-GE 


Multi_to_Norwegian_NRC = CF( 
CF = ..IDENTITY, MODI = ( 
"A" = , 

"A" = "]", 

H^i, _ i. [ n # 

" 0 " = "\", 

II 'Q II _ II A II 

II 0 II _ II / II 

"A" = "}", 

"ae" = 

" 0 " = "|", 

ii Vi •• — •• » 

U — / 

"" = %X00)); 

ZK-6600-GE 
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National Character Set Definitions 


Multi_to_Swedish_NRC = CF( 

CF = _IDENTITY ( MODI = ( 



H-QII _ II ^ II 

"" = %X00)); 

ZK-6601-GE 

Mul t i_t o_Swi s s_NRC = CF ( 

CF = _IDENTITY, MODI = ( 



II t' II _ II A II 
- 1 - — / 

II Q II _ II / II 

"6" = "|"\ 

"u" = 

"" = %X00)); 

ZK-6602-GE 


Multi_to_Uk_NRC = CF( 

CF = _IDENTITY, MODI = ( 

H £ ii _ ii ^ ii 

"" = %X00)); 

ZK-6603-GE 

Multi_to_Upper = CF( 

CF = _IDENTITY, MODI = ( 

" 3." —" z 11 = " A" — 11 Z" 

"a"-"I" = "A"-"I", 

"n"-"y" = "N"-"Y", 

"GE" = "OE", 

= "SS", 

"" = %X00)); 

ZK-6604-GE 
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National Character Set Definitions 


Norwegian = CS( 






, "a". 

SEQUENCE = 

(%X00 

-"N", 

"N 

", "0"- 

_"Z" 

%XDE 

, %XFO, %XFE- 

%XFF), 



MODIFICATIONS=(" 

a" -" z 

ii _ 

"A"-" Z" , 

"A"-"A 

ll J " _ ll 

1" = 

"I", 

"6" 

-„0" = 

"0" 

, "0" : 

"a"-" 

a" = 

"A", 

"A" 

-"ae" = 

"A" 

-"A", 


1" = 

"1", 

"n" 

= "N", 

, "6 

II __ II q II 

" u" - " 

u" = 

"U", 

"u" 

_ "y " - 

ii y •• 

, "A" : 

"a" = 

: "A", 

"CE" 

_ l 

"CE", " 1 

" < 

%X00)) 


+ CS( SEQUENCE = (%X00-"A", "A"-"A", "B"- 
"F"-"I", "1"-"I", "J"-"N", "N", ”CE 
"S"_"U", "U"-"U", "V"-"Y", "Y", "Z" 
%XD0, %XDE, %XF0, %XFE-%XFF), 
MODIFICATIONS= ("a"-"z" = , 'A"-"Z", "a”-"!" 
+ REVERSE(_NATIVE); 


"0", "A", " 


_ II II II _ HQH II 

"0", "Cj"-"0" = "U", 



"AE" = "CE" = "OE", 


"C", "Q", "D"-"E", " 
", "0", "0"-"6", "P" 

, "A", "0", "A", "[" 



{"-"d", %XD0, 



E"-"E", 

-"R", "6", 

_ ll / ll H / H _ H • 'I 


= "N"-"Y") ) 


ZK-6605-GE 


Norwegian_NRC_to_Multi = CF( 
CF = _IDENTITY, MODI = ( 


II \ II 

ll /\ ll 
II / ll 
ll { ll 
II | ll 


: "A", 

: "R", 

- " 0 " / 

= "A", 

= "U", 

= "a", 

= "ae", 

= " 0 ", 

= "a", 

= "ii", 
%X00)); 


ZK-6606-GE 


Portuguese = CS( 

SEQUENCE = (%XOO-"N", "N", "0“-"Z", "A”, "0", "A”, "{"-"i", %XDO, 

%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "A"-"A" = "A", "Q" = "C", "E"-"E" = "E", 

_ « I « / _ -o", "U"-"U" = "U", "Y" = "Y", "a"-"a" = "A", 

"A"-"ae" = "A"-"A", "<?" = "C", "e"-"e" = "E", = "I", "n" = "N", 

= "0", " 0 " = "0", "u"-"u" = "U", "y" = "Y", "CE" = "OE", 

"6" = "SS", "ce" = "CE", "" < %X00)) 

+ CS( SEQUENCE = (%XOO-"A", "A"-"A", "B"-"C", "C" < «d"-"E", "E"-"E", 

"I"-"I", "J"-"N", "N", "CE", "0", "0"-"0", "p"—"R", 

»S"_"U""U"-"U", "V"-"Y", "Y", "Z", "A", "0", "A", 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "a"-"I" = "A"-"!", "n"-”y" = "N"-"Y")) 

+ REVERSE(_NATIVE); 

ZK-6607-GE 
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National Character Set Definitions 


Spanish = CS( 

SEQUENCE = (%X00-"B'\ "Q", "CH", "D"-"L", "LL", "M"-"N" ( "N", "0"-"Z", "R", 
"0", "A", "{"-"i", %XD0, %XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS=("a"-"b" = "A"—"B", "d"-"k" = "D"-"K" ( 

"A"-"A" = "A", "E"-"E" = "E\ = "I", "0"—"O" = "O", 

"U"—"U" = "U", "Y" = "Y", "a"—"a" = "A", "A"—"p" = "A"—"C" 

"e"-"e" = "E", " 1" -" I" = "i", "ft» = "N " t "6"-"6" = "O", " 0 " = "0", 
"u"-"u" = "U", "y" = "Y", "C" = "C", "Ch" = "CH", "LI" = "LL", 

"c" = "Q", "cH" = "CH", "ch" = "CH", "1" = "L", "1L" = "LL", 

"11" = "LL", "CE" = "OE", "E" = "SS", ”ce" = "CE", "" < %X00)) 

+ CS( SEQUENCE = (%X00—"A", "A"—"A", "B"—"C", "C"/ "D"—"E", "E"—"6", 

"p"_ » j » ( "I"-"I", "J"-"N" , "N", "CE", "0", "O"-"0", "P»-"R", »6», 
"S"-"U“, "U"-"U", "V"-"Y", "Y", "Z", "A", "0", "A", 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "A"-"I" = "A"-"l", "n"-"y" = "N"-"Y")) 

+ REVERSE(_NATIVE); 


ZK-6608-GE 


Swedish_NRC_to_Multi = CF( 

CF = _IDENTITY, MODI = ( 

11011 _ II g ii 

"[" = "A", 

"\" = "O", 



— u. / 

"” = %X00)); 

ZK-6609-GE 

Swiss_NRC_to_Multi = CF( 

CF = _IDENTITY, MODI = ( 



"f" = "a" 


,,,, = %X00) ) ; 

ZK-6610-GE 


Uk_NRC_t o_Mu11i = CF( 

CF = _IDENTITY, MODI = ( 

II ^ II _ II £ II 

,,,, = %X00) ) ; 

ZK-6611-GE 
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Index 


A_ 

Alternate NCS library, specifying 
See /LIBRARY qualifier 
ASCII SPACE character 

using as pad character, NCS-10 

B _ 

/BEFORE qualifier, NCS-23 
Built-in definition 
function of, NCS-7 

.IDENTITY conversion function, NCS-8 
.NATIVE collating sequence, NCS-7 

c_ 

CF keyword 

description, NC S-15 
Collating sequence 
creating 

limitation, NCS-9 

using appended collating sequence, NCS-9 
using modified collating sequence, NCS-9 
using name of existing collating sequence, 
NCS-8 

using reordered collating sequence, 

NCS-10 

using reversed collating sequence, NCS-9 
using series of expressions, NCS-8 
expression forms listed, NCS-8 
MODIFICATIONS keyword clause formats 
listed, NCS-16 

/COMPRESS qualifier, NCS-24 
Conversion function 
creating 

using inverted conversion function, 

NCS-11 

using modified conversion function, 

NCS-11 

using name of existing conversion function, 
NCS-10 

using reordered conversion function, 

NCS-12 

using series of conversion functions, 

NCS-11 

expression forms listed, NCS-10 


Conversion function (cont’d) 

MODIFICATIONS keyword clause format, 
NCS-15 

processing order for multiple conversion 
functions, NCS-11 

using to create collating sequence, NCS-9 
/CREATE qualifier, NCS-24 
CS keyword 

description, NCS-12 

D _ 

Data format in NCS library 

specifying with /DATA qualifier, NCS-26 
/DATA qualifier, NCS-26 
Data-expanded format 

using /DATA qualifier, NCS-26 
Data-reduced format 

using /DATA qualifier, NCS-26 
Default file type 

for NCS definition files specified by /OUTPUT 
qualifier, NCS-39 
for NCS input files, NCS-21 
for NCS library, NCS-33 
for NCS library listing output file, NCS-34 
for NCS library specified by /COMPRESS 
qualifier, NCS-39 

for output files created by /MACRO qualifier, 
NCS-28 

for output files created by /OUTPUT qualifier, 
NCS-28 

Default insertion 

in lieu of module replacement, NCS-40 
Default values 

overriding with /COMPRESS qualifier, 
NCS-24 
Definition 

built-in, NCS-7 
Definition file 

characteristics, NCS-4 
example, NCS-4 
format, NCS-4 

generated by /OUTPUT qualifier, NCS-39 
how to build, NCS-4 
language notation, NCS-6 
naming, NCS-4 
structure, NCS-4 
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Definition file output from NCS library 
See /OUTPUT qualifier 
Definition module 

deleting from NCS library 
See /DELETE qualifier 
extracting from NCS library 
See /EXTRACT qualifier 
inserting in NCS library 
See /INSERT qualifier 
specifying name length, NCS-24 
Definition module, replacing 
See /REPLACE qualifier 
/DELETE qualifier 

for deleting definition modules from NCS 
library, NCS-27 
Delimiters 

for specifying multiple definition modules, 
NCS-27, NCS-28, NCS-32, NCS-38 
for specifying multiple input files, NCS-21 
Destination file specification 
requirement, NCS-36 
Disk space efficiency 
See /DATA qualifier 
Disk space, recovering 

See /COMPRESS qualifier 

E__ 

EXPAND keyword 

for /DATA qualifier, NCS-26 
/EXTRACT qualifier 

for extracting definition modules from NCS 
library, NCS-28 

F _ 

File type 

default for input files, NCS-21 
/FORMAT qualifier, NCS-29 
/FULL qualifier, NCS-30 

used with the /LIST and /HISTORY qualifiers, 
NCS-31 

G 

Global label 

use with NCS routines, NCS—36 

H_ 

/HISTORY qualifier 

used to limit listing output, NCS-31 


I _ 

IDENT keyword 

using to identify conversion function, NCS-13, 
NCS-15 
Input files 

default file type for, NCS-21 
specifying for NCS command, NCS—21 
/INSERT qualifier, NCS-32 

K__ 

256 keyword 

for /FORMAT qualifier, NCS-29 
Keyword clause 

types used in collating sequence expression, 
NCS-12 

types used in conversion function expressions, 
NCS-14 
Keywords 

for /FORMAT qualifier, NCS-29 

L_ 

/LIBRARY qualifier, NCS-33 
/LIST qualifier 

default output destination, NCS-34 
for obtaining listing of NCS library, NCS-34 
information provided by, NCS-34 
specifying output file, NCS-34 
used with /BEFORE qualifier, NCS-23 
used with /FULL qualifier, NCS-30 
used with /HISTORY qualifier, NCS-31 
used with /ONLY qualifier, NCS-38 
used with other qualifiers, NCS-34 
used with /SINCE qualifier, NCS-41 
Listing, obtaining 
See /LIST qualifier 
/LOG qualifier 

for verifying NCS library operations, NCS-35 

M__ 

/MACRO qualifier, NCS-36 
MACRO-32 file format, from NCS library 
See /FORMAT qualifier 
MACRO-32 output, from NCS library 
See /MACRO qualifier 
Maximum number of history records 

NCS library, specifying, NCS-24, NCS-25 
MODIFICATIONS keyword 

using in collating sequence expression, NCS-14 
using in conversion function expression, 

NCS-15 
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MODIFICATIONS keyword clause, NCS-16 
Modules 

replacing in the default NCS library, NCS-21 
Multinational Character Set, NCS-3 
Multiple definition modules 

specifying with /DELETE qualifier, NCS-27, 
NCS-32 

specifying with /EXTRACT qualifier, NCS-28 
specifying with /ONLY qualifier, NCS-38 
Multiple input files 
specifying, NCS-21 

N _ 

National Character Set Utility 
See NCS Utility 
NCS command 

specifying input files for, NCS-21 
NCS keyword 

for /FORMAT qualifier, NCS-29 
NCS library 

creating, NCS-25 

See also /CREATE qualifier 
deleting definition modules from, NCS-27 
extracting definition modules from, NCS-28 
generating MACRO-32 output from, NCS-36 
generating NCS definition files from, NCS-39 
inserting definition modules, NCS-32 
obtaining listing of, NCS-34 
replacing definition modules, NCS-40 
specifying an alternate, NCS-33 
specifying history records, NCS-24, NCS-25 
specifying MACRO-32 output format, NCS-29 
specifying maximum length of definition module 
names, NCS-24, NCS-25 
specifying maximum number of modules, 
NCS-24, NCS-25 
specifying size, NCS-24, NCS-25 
verifying operations, NCS-35 
with data-expanded format, NCS-26 
with data-reduced format, NCS-26 
NCS Utility, NCS-3 
DCL interface 

default function, NCS-3 
library functions, NCS-3 
directing output, NCS-21 
exiting, NCS-21 


functions, NCS-3 
implementation, NCS-3 
Number of modules 

in NCS library, specifying, NCS-24, NCS-25 

O_ 

/ONLY qualifier, NCS-38 
/OUTPUT qualifier, NCS-39 

P_ 

Pad character 

in collating sequence, NCS-10 

R_ 

REDUCE keyword 

for /DATA qualifier, NCS-26 
/REPLACE qualifier, NCS-40 
Required values 

for /DATA qualifier, NCS-26 

S_ 

SEQUENCE keyword 
description, NCS-13 
/SINCE qualifier, NCS-41 
Size 

NCS library, specifying, NCS-24, NCS-25 
String 

how denoted, NCS-7 

limit on numeric representation, NCS-7 

ranges used in collating sequence, NCS-17 

V__ 

Verification of NCS library operations 
See /LOG qualifier 

W_ 

Wildcard characters 

use of, NCS-27, NCS-28, NCS-38 
use restriction, NCS-34, NCS-36 
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How to Order Additional Documentation 


Technical Support 

If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825) 
and press 2 for technical assistance. 


Electronic Orders 

If you wish to place an order through your account at the Electronic Store, dial 800-234-1998, using a 
modem set to 2400- or 9600-baud. You must be using a VT terminal or terminal emulator set at 8 bits, no 
parity. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825) and ask for an 
Electronic Store specialist. 


Telephone and Direct Mail Orders 


From 

Call 

Write 

U.S.A. 

DECdirect 

Phone: 800-DIGITAL 
(800-344-4825) 

FAX: (603) 884-5597 

Digital Equipment Corporation 

P.O. Box CS2008 

Nashua, NH 03061 

Puerto Rico 

Phone: (809) 781-0505 
FAX: (809) 749-8377 

Digital Equipment Caribbean, Inc. 
3 Digital Plaza, 1st Street 

Suite 200 

Metro Office Park 

San Juan, Puerto Rico 00920 

Canada 

Phone: 800-267-6215 
FAX: (613) 592-1946 

Digital Equipment of Canada Ltd. 
100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 
Attn: DECdirect Sales 

International 


Local Digital subsidiary or 
approved distributor 

Internal Orders 1 
(for software 
documentation) 

DTN: 241-3023 
(508) 874-3023 

Software Supply Business (SSB) 
Digital Equipment Corporation 

1 Digital Drive 

Westminster, MA 01473 

Internal Orders 
(for hardware 
documentation) 

DTN: 234-4325 
(508) 351-4325 

FAX: (508) 351-4467 

Publishing & Circulation Services 
Digital Equipment Corporation 
NR02-2 

444 Whitney Street 

Northboro, MA 01532 






1 Call to request an Internal Software Order Form (EN-01740-07). 
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